Skip to content

Conversation

@petebacondarwin
Copy link
Contributor

@petebacondarwin petebacondarwin commented Jan 20, 2026

Summary

Adds a new section to the Wrangler login command documentation explaining how to configure OAuth login when running Wrangler inside a container.

This documents the use of --callback-host and --callback-port options for container environments where localhost inside the container is not accessible from the host machine's browser. The section explains:

  • Why the standard login flow doesn't work in containers (localhost isolation)
  • How to configure port mapping from host to container
  • How to use --callback-host=0.0.0.0 to listen on all interfaces
  • An example with custom port mapping using --callback-port

Related to: cloudflare/workers-sdk#9396

Requested by: @petebacondarwin

Link to Devin run: https://app.devin.ai/sessions/32f8502dad7e4b699e7048039209ab44

Updates since last revision

  • Updated section content per @emily-shen's suggested rewrite
  • Changed section title from "Docker container" to "container" for broader applicability
  • Restructured to explain port mapping requirement first, then the callback-host option

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR that start with 'DevinAI' or '@devin'.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions github-actions bot added product:workers Related to Workers product size/s labels Jan 20, 2026
@github-actions
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/workers/wrangler/ @cloudflare/wrangler, @irvinebroque, @cloudflare/pcx-technical-writing

@github-actions
Copy link
Contributor

github-actions bot commented Jan 20, 2026

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
@devin-ai-integration devin-ai-integration bot changed the title docs: add documentation for wrangler login in Docker containers docs: add documentation for wrangler login in containers Jan 20, 2026
@petebacondarwin petebacondarwin merged commit e2e3a69 into production Jan 20, 2026
9 checks passed
@petebacondarwin petebacondarwin deleted the devin/1768911328-wrangler-login-docker branch January 20, 2026 15:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants